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ABSTRACT 


A report  generetori  iinpleinented  ss  3 series  of  Zilog 
Development  System  conmands,  is  reported.  It  is,  of  course, 
generated  by  the  system  it  reports.  Its  salient  feature  is 
the  automatic  inclusion  of  otherwise  independent  material 
throi«h  access  to  the  file  system  during  report  generation. 


SECTION  1.  Introduction. 


Generating  a technical  report  involves  both  the  preparation 
of  descriptive  text  as  well  as  the  inclusion  of  other  material 
such  as  tables  and  programs  that  have  an  independent  existence 
of  their  own.  It  is  helpful  if  the  generation  of  the  report  can 
automatically  Include  the  latest  version  of  such  extra  materials 
rather  than  having  them  incorporated  into  the  prepared  text  at 
some  earlier  time.  It  is  for  such  a purpose  that  the  system 
described  here  is  designed. 

Ihe  context  of  this  system  is  the  Zilog  Development  System 
which  includes  a command  language  for  file  manipulation  as  well 
as  editors  and  similar  aids  for  report  generation.  Information 
about  these  systems  can  be  obtained  f^om  the  appropriate  manuals 
as  noted  in  the  bibliographyd ,2]. 

A file  in  the  Zilog  system  can  be  either  a text  file  or  a 
coomand  file  depending  upon  the  way  it  is  addressed.  A ccmmand 
of  the  form: 


DO  XXX; 

accesses  the  file  named  XXX  and  obeys  the  commands  in  it.  A 
DO  command  can  have  paraneters  which  follow  the  name  of  the 
file;  within  the  command  file  the  parameters  are  designated 
by  the  symbols  #1,  #2,  etc.  Finally  a command  of  the  form: 

COPY  XXX  $CON; 

accesses  the  file  named  XXX  and  causes  it  to  be  displayed  on 
the  user’s  console.  With  this  brief  introduction  the  reader 
should  be  able  to  understand  the  details  now  to  be  reported. 

This  report  was  in  fact  generated  by  the  report  generator 
as  will  become  apparent.  There  are  two  output  devices  addressed 
by  the  program:  $CON  and  $DIABLO.  The  former  is  the  CRT  con- 
sole; the  latter  is  a Diablo  printer.  It  is  upon  the  latter 
that  this  report  is  printed. 
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SECTION  2.  A Report  Generating  Report  Generated. 

Below  are  presented  a series  of  command  files  that  are 
activated  by  the  DO  command.  For  ease  of  Identification  each 
such  file  contains  an  Initial  CCHMENT  which  gives  the  name  of 
the  file.  There  are  four  files  for  which  the  Information  can- 
not be  easily  displayed.  They  are: 

NULL  This  Is  a file  that  contains  .nothing  and  therefore  has 
no  effect  if  printed  out. 

CGMHENT  This  file  is  absolutely  empty  also.  It  is  used  only 
as  a command  file  and  has  no  effect  when  executed.  NULL 
could  equally  well  have  been  used  except  that  the  mnemonic 
name  CCMMEST  was  desired.  Che  may  later  wish  to  consider 
the  reason  that  CCMMENT  does  not  contain  a comment  Itself. 
Up>on  reflection  one' will  realize  that  vAiile  CCMMENT  does 
nothing,  it  could  do  it  forever  if  it  contained  a comment. 

DOUBLESPACE  This  file  contains  two  blank  lines. 

FORMFEED  This  file  contains  the  single  character  for  formfeed, 
i.e.,  control  Lor  Hex  CO. 

There  are  in  addition  some  files  named  P.m.n  where  m and  n 
are  small  integers.  They  correspond  to  pages  or  parts  of  pages 
of  textual  information. 

To  get  a copy  of  this  report  on  a system  which  has  all  the 
relevant  files,  type 

DO  REPORT; 


and  stand  back. 

The  commands  that  are  triggered  off,  starting  with  REPORT 
itself,  are: 


DO  CCMMENT  This  is  file  REPORT; 

DO  CCMMENT  First  suppress  extraneous  output; 

B; 

IX)  CCMMENT  Form  feed  to  get  clean  sheet; 

DO  PAGE  NULL; 

DO  PAGE  TITLE; 

DO  PAGE  ABSTRACT; 

DO  SECTION!; 

DO  SECTIC»J2; 

DO  PAGE  BIB; 


DO  CCMMENT  This  is  file  PRINT; 
COPY  #1  $DIABLO; 


ro  CCMMENT  This  is  file  PAGE; 
DO  PRINT  II; 

DO  PRINT  FORMFEED; 


n 


3. 

DO  CCMMENT  This  is  file  SECTION  1; 

DO  PAGE  P.1.1; 


DO  CCMMENT  This  is  file  SECTION2; 
DO  PRINT  P.2.1; 

DO  PRINT  DOUBLESPACE; 

DO  PRINT  REPORT; 

DO  PRINT  DOUBLESPACE; 

DO  PRINT  PRINT; 

DO  PRINT  DOUBLESPACE; 

DO  PAGE  PAGE; 

DO  PRINT  P.2.2; 

DO  PRINT  SECTION  1; 

DO  PRINT  DOUBLESPACE; 

DO  PRINT  SECTION2; 

DO  PRINT  DOUBLESPACE; 

DO  PAGE  P.2.3; 


There  is  little  more  to  say.  The  editor  can  be  used  to 
change  $DIABLO  to  $CON  in  PRINT  to  allow  the  user  to  interact 
with  his  report  on  the  CRT.  The  reverse  change  will  direct 
the  output  to  the  hardcopy  device  when  desired.  Note  that  it 
is  therefore  difficult  to  get  a copy  of  this  report  with  $CON 
in  file  PRINT. 
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